home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 43 / Amiga Format CD43 (1999)(Future Publishing)(GB)(Track 1 of 2)[!][issue 1999-09].iso / -in_the_mag- / workbench / sql / msql-2.0.10.1 / install < prev    next >
Text File  |  1999-06-14  |  4KB  |  82 lines
  1. Installation instructions for mSQL Version 2.0
  2. ---------------------------------------------- 
  3.  
  4. NOTE :    A complete guide to the compilation, installation and
  5.     configuration is included in the first section of the User
  6.     Guide.  Installation troubleshooting information is also
  7.     included in the User Guide for those having problems installing
  8.     mSQL.  The User Guide can be found in the doc/ directory of this
  9.     distribution.
  10.  
  11. ------------------------------------------------------------------------------
  12. A quick outline of the installation process is given below.
  13.  
  14.  
  15. 1.    Unpack the source code.
  16.  
  17. 2.     In the root directory of the distribution type "make target".  This 
  18.     will create a "symbolic link tree" for your platform under the 
  19.     targets/ directory.  For example, on a BSD/OS machine you may end up 
  20.     with a replica of the source code directory in targets/BSD_OS-2.1-i386/
  21.  
  22. 3.    Change directory to the target directory for your machine.
  23.  
  24. 4.    Run the setup utility (Note: use ./setup to ensure you get the
  25.     mSQL setup utility and not a system utility).
  26.  
  27. 5.    After setup has completed,  you can edit a couple of default
  28.     configuration values in site.mm if you wish.  When you are happy
  29.     type "make all"
  30.  
  31. 6.    If the compilation of mSQL completes properly, type "make install"
  32.     This will install all the mSQL related files under /usr/local/Hughes
  33.     (or whatever directory you set as the install directory in site.mm) 
  34.     You may need root access to perform this step.
  35.  
  36. 7.    Edit /usr/local/Hughes/msql.conf to see if everything is OK.
  37.     The only thing you might change in a normal installation is the
  38.     username of the mSQL_User or the Admin_User.  By default, mSQL is 
  39.     configured to run as a user called 'msql' with root being the admin
  40.     user (i.e. the one who can create databases, shutdown the server
  41.     etc).
  42.  
  43. 8.    Ensure that the installation directory (and everything under it)
  44.     is owned by the user that mSQL will run as (e.g. the msql user).
  45.     To do this, issue a command like "chown -R msql /usr/local/Hughes".
  46.     Substitute the correct username and installation directory if
  47.     you are running a non-default installation.
  48.  
  49. 9.    If you wish to use the WWW interface package, W3-mSQL, you
  50.     should start the mSQL server (by running /usr/local/Hughes/bin/msql2d &)
  51.     and then execute misc/setup_w3auth.  This will setup a couple of
  52.     databases and install the Hughes Technologies related web page
  53.     graphics etc. into your web tree.  You'll need to be running as
  54.     the mSQL Root_User as this creates several databases.  You may
  55.     also need to run as a specific user to modify your web tree.
  56.     Note : setup_w3auth expects to find Lite installed in the default
  57.     location.  If you installed into anywhere other than
  58.     /usr/local/Hughes please edit the first line of the
  59.     setup_www script to reflect the location of the Lite binary.
  60.  
  61. 10.    If you want to use W3-mSQL you'll need to copy w3-auth and
  62.     w3-msql from /usr/local/Hughes/bin to your cgi-bin directory (or
  63.     provide a symbolic link to them from your cgi-bin).  You will
  64.     also need to copy the graphics files used by these tools into
  65.     your web tree.  Create a directory called 'Hughes' at the top
  66.     of your web tree and then copy the demos/w3-msql/graphics
  67.     directory into the newly created 'Hughes' directory (i.e.
  68.     using a browser you could load
  69.     http://your.host/Hughes/graphics/hughes.gif)
  70.  
  71. 11.    If you want to install the sample W3-mSQL application (the 
  72.     bookmarks database), read the README file contained in the
  73.     demos/w3-msql/bookmarks directory.
  74.  
  75.  
  76. Note : To use the W3-mSQL authentication / access control features
  77. you'll need a web server that passes authentication headers to CGI
  78. scripts.  The CERN server does this and a patch is available from Hughes
  79. Technologies to add this feature to the Apache server.  The Apache patch
  80. is available for both 1.1 and 1.2 versions of Apache.  Please see the
  81. Software section of www.Hughes.com.au for details.
  82.